home *** CD-ROM | disk | FTP | other *** search
/ Merciful 1 / Merciful - Disc 1.iso / software / d / devpak / devpakv3.01kickstartv1.3b.dms / devpakv3.01kickstartv1.3b.adf / arp / prodocs / StrtoStamp < prev    next >
Text File  |  1991-11-20  |  2KB  |  133 lines
  1.  
  2.  
  3.  
  4.      StrtoStamp(33.4)      ARP Programmers Manual      StrtoStamp(33.4)
  5.  
  6.  
  7.  
  8.      NAME
  9.       StrtoStamp - convert ASCII portion of    DateTime structure to
  10.           a DateStamp.
  11.  
  12.      SYNOPSIS
  13.       error    = StrtoStamp(DateTime)
  14.         d0            A0
  15.  
  16.      FUNCTION
  17.       Converts a human readable ASCII string into an AmigaDOS
  18.       DateStamp.
  19.  
  20.      INPUTS
  21.       DateTime - a pointer to an initialized DateTime structure.
  22.  
  23.       The DateTime structure should    be initialized as follows:
  24.  
  25.       dat_Format - a format    byte which specifies the format    of the
  26.           dat_StrDat.  This can    be any of the following    (note:
  27.           If value used    is something other than    those below,
  28.           the default of FORMAT_DOS is used):
  29.  
  30.           FORMAT_DOS:      AmigaDOS format (dd-mmm-yy).
  31.  
  32.           FORMAT_INT:      International    format (yy-mmm-dd).
  33.  
  34.           FORMAT_USA:      American format (mm-dd-yy).
  35.  
  36.           FORMAT_CDN:      Canadian format (dd-mm-yy).
  37.  
  38.       dat_Flags - a    flags byte.  The only flag which affects this
  39.           function is:
  40.  
  41.           DTB_FUTURE:      If set, indicates that strings such
  42.                   as (stored in    dat_StrDate) "Monday"
  43.                   refer    to "next" monday. Otherwise,
  44.                   if clear, strings like "Monday"
  45.                   refer    to "last" monday.
  46.  
  47.       dat_StrDate -    pointer    to valid string    representing the date.
  48.           This can be a    "DTB_SUBST" style string such as
  49.           "Today" "Tomorrow" "Monday", or it may be a string
  50.           as specified by the dat_Format byte.    This will be
  51.           converted to the ds_Days portion of the DateStamp.
  52.           If this pointer is NULL, DateStamp->ds_Days will not
  53.           be affected.
  54.  
  55.       dat_StrTime -    Pointer    to a buffer which contains the time in
  56.           the ASCII format hh:mm:ss.  This will    be converted
  57.           to the ds_Minutes and    ds_Ticks portions of the
  58.           DateStamp.  If this pointer is NULL, ds_Minutes and
  59.           ds_Ticks will    be unchanged.
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 2/22/88)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      StrtoStamp(33.4)      ARP Programmers Manual      StrtoStamp(33.4)
  71.  
  72.  
  73.  
  74.      RESULT
  75.       error    - a non-zero return indicates that a conversion    could
  76.           not be performed. A Zero return indicates that the
  77.           DateTime.dat_Stamp variable contains the converted
  78.           values.
  79.  
  80.      BUGS
  81.       None known
  82.  
  83.      SEE ALSO
  84.       StamptoStr
  85.  
  86.      AUTHOR
  87.       KRS
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 2/22/88)
  130.  
  131.  
  132.  
  133.